Skip to main content

Payments Life Cycle


This document outlines the payment flows and their transitional states for various payment types, including Sale, Pre-Auth and Failed Payments.

It describes the sequence of statuses a payment progresses through, such as PENDING, AUTHORIZED, COMPLETED, ACCEPTED and FAILED, and highlights the corresponding webhook events (PAYMENT_SUCCEEDED, PAYMENT_FAILED, PAYMENT_AUTHORIZED, PAYMENT_CANCELED and PAYMENT_ACCEPTED) triggered at each stage.

The flowcharts provide a clear visual representation of the decision points and transitions for each payment type.


Flow chart for PreAuth Payments

Quick Note: Capture must occur before authorization expires (typically within 7 days).
If not captured within 7 days, the payment will automatically be canceled.


Flow chart for SALE Payments


Flow chart for FAILED Payments


Flow chart for ACH PAYMENTS

Quick Note: For ACH payments, PAYMENT_ACCEPTED signifies that the payment has been initiated and accepted but is pending settlement, which can take several days.